package com.danciyixue.boot.dcyx.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.danciyixue.boot.client.test.model.UnitTestItem;
import com.danciyixue.boot.client.test.model.UnitTestQuery;
import com.danciyixue.boot.dcyx.model.entity.Tests;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.danciyixue.boot.dcyx.model.query.TestsQuery;
import com.danciyixue.boot.dcyx.model.vo.TestsVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * 测试试卷信息Mapper接口
 *
 * @author youlaitech
 * @since 2025-06-15 16:21
 */
@Mapper
public interface TestsMapper extends BaseMapper<Tests> {

    /**
     * 获取测试试卷信息分页数据
     *
     * @param page 分页对象
     * @param queryParams 查询参数
     * @return {@link Page<TestsVO>} 测试试卷信息分页列表
     */
    Page<TestsVO> getTestsPage(Page<TestsVO> page, TestsQuery queryParams);

    /**
     * 根据教材ID和测试类型查询已存在的测试
     *
     * @param programId 教材ID
     * @param type 测试类型
     * @return 测试试卷
     */
    Tests findByProgramIdAndType(@Param("programId") Long programId, @Param("type") Integer type);

    /**
     * 获取单元测试项分页数据
     *
     * @param page 分页对象
     * @param queryParams 查询参数
     * @return 单元测试项分页列表
     */
    Page<UnitTestItem> getUnitTestItems(Page<UnitTestItem> page, @Param("queryParams") UnitTestQuery queryParams, @Param("userId") Long userId);

    /**
     * 根据单元ID和测试类型查询已存在的测试
     *
     * @param unitId 单元ID
     * @param type 测试类型
     * @return 测试试卷
     */
    Tests findByUnitIdAndType(@Param("unitId") Long unitId, @Param("type") Integer type);

}
